Node / meshtastic / Meshtastic-Android / files / core / model / src / commonMain / kotlin / org / meshtastic / core / model / util / ChannelSet.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tf0883e@fileTb4b4b4:Te6edf3SuppressTb4b4b4(Ta5d6ff"Ta5d6ffMagicNumberTa5d6ff"Tb4b4b4)

Tff7b72package T7ee787org.meshtastic.core.model.util

Tff7b72import T7ee787okio.ByteString.Companion.decodeBase64

Tff7b72import T7ee787okio.ByteString.Companion.toByteString

Tff7b72import T7ee787org.meshtastic.core.common.util.CommonUri

Tff7b72import T7ee787org.meshtastic.core.model.Channel

Tff7b72import T7ee787org.meshtastic.proto.ChannelSet

Tff7b72import T7ee787org.meshtastic.proto.Config.LoRaConfig

T8b949e/**

* Return a [ChannelSet] that represents the ChannelSet encoded by the URL.

*

* @throws MalformedMeshtasticUrlException when not recognized as a valid Meshtastic URL

*/

Tf0883e@ThrowsTb4b4b4(Te6edf3MalformedMeshtasticUrlExceptionTff7b72::Te6edf3classTb4b4b4)

Tff7b72fun Te6edf3CommonUriTb4b4b4.Td2a8fftoChannelSetTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ChannelSet Tb4b4b4{

Tff7b72val Te6edf3h Tff7b72= Te6edf3host Tff7b72?: Ta5d6ff"Ta5d6ff"

Tff7b72val Te6edf3isCorrectHost Tff7b72=

Te6edf3hTb4b4b4.Te6edf3equalsTb4b4b4(Te6edf3MESHTASTIC_HOSTTb4b4b4, Te6edf3ignoreCase Tff7b72= Tff7b72trueTb4b4b4) Tff7b72|Tff7b72| Te6edf3hTb4b4b4.Te6edf3equalsTb4b4b4(Ta5d6ff"Ta5d6ffwww.Tffd700$Te6edf3MESHTASTIC_HOSTTa5d6ff"Tb4b4b4, Te6edf3ignoreCase Tff7b72= Tff7b72trueTb4b4b4)

Tff7b72val Te6edf3segments Tff7b72= Te6edf3pathSegments

Tff7b72val Te6edf3isCorrectPath Tff7b72= Te6edf3segmentsTb4b4b4.Te6edf3any Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3equalsTb4b4b4(Ta5d6ff"Ta5d6ffeTa5d6ff"Tb4b4b4, Te6edf3ignoreCase Tff7b72= Tff7b72trueTb4b4b4) Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3fragmentTb4b4b4.Te6edf3isNullOrBlankTb4b4b4(Tb4b4b4) Tff7b72|Tff7b72| Tff7b72!Te6edf3isCorrectHost Tff7b72|Tff7b72| Tff7b72!Te6edf3isCorrectPathTb4b4b4) Tb4b4b4{

Tff7b72throw Te6edf3MalformedMeshtasticUrlExceptionTb4b4b4(Ta5d6ff"Ta5d6ffNot a valid Meshtastic URL: Tffd700${Te6edf3toStringTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3takeTb4b4b4(T79c0ff4T79c0ff0Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4)

Tb4b4b4}

T8b949e// Older versions of Meshtastic clients (Apple/web) included `?add=true` within the URL fragment.

T8b949e// This gracefully handles those cases until the newer version are generally available/used.

Tff7b72val Te6edf3fragmentBase64 Tff7b72= Te6edf3fragmentTff7b72!!Tb4b4b4.Te6edf3substringBeforeTb4b4b4(Ta5d6ff'?'Tb4b4b4)Tb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff'-'Tb4b4b4, Ta5d6ff'+'Tb4b4b4)Tb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff'_'Tb4b4b4, Ta5d6ff'/'Tb4b4b4)

Tff7b72val Te6edf3fragmentBytes Tff7b72=

Te6edf3fragmentBase64Tb4b4b4.Te6edf3decodeBase64Tb4b4b4(Tb4b4b4)

Tff7b72?: Tff7b72throw Te6edf3MalformedMeshtasticUrlExceptionTb4b4b4(Ta5d6ff"Ta5d6ffInvalid Base64 in URL fragment: Tffd700$Te6edf3fragmentBase64Ta5d6ff"Tb4b4b4)

Tff7b72val Te6edf3url Tff7b72= Te6edf3ChannelSetTb4b4b4.Te6edf3ADAPTERTb4b4b4.Te6edf3decodeTb4b4b4(Te6edf3fragmentBytesTb4b4b4)

Tff7b72val Te6edf3shouldAdd Tff7b72=

Te6edf3fragmentTff7b72?.Te6edf3substringAfterTb4b4b4(Ta5d6ff'?'Tb4b4b4, Ta5d6ff"Ta5d6ff"Tb4b4b4)Tff7b72?.Te6edf3takeUnless Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3isBlankTb4b4b4(Tb4b4b4) Tb4b4b4}Tff7b72?.Te6edf3equalsTb4b4b4(Ta5d6ff"Ta5d6ffadd=trueTa5d6ff"Tb4b4b4)

Tff7b72?: Te6edf3getBooleanQueryParameterTb4b4b4(Ta5d6ff"Ta5d6ffaddTa5d6ff"Tb4b4b4, Tff7b72falseTb4b4b4)

Tff7b72return Tff7b72if Tb4b4b4(Te6edf3shouldAddTb4b4b4) Te6edf3urlTb4b4b4.Te6edf3copyTb4b4b4(Te6edf3lora_config Tff7b72= Tff7b72nullTb4b4b4) Tff7b72else Te6edf3url

Tb4b4b4}

T8b949e/** @return A list of globally unique channel IDs usable with MQTT subscribe() */

Tff7b72val Te6edf3ChannelSetTb4b4b4.Te6edf3subscribeListTb4b4b4: Te6edf3ListTff7b72<Tffa657StringTff7b72>

Tff7b72getTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3loraConfig Tff7b72= Tff7b72thisTb4b4b4.Te6edf3lora_config Tff7b72?: Te6edf3LoRaConfigTb4b4b4(Tb4b4b4)

Tff7b72return Te6edf3settingsTb4b4b4.Te6edf3filter Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3downlink_enabled Tb4b4b4}Tb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3ChannelTb4b4b4(Tffa657itTb4b4b4, Te6edf3loraConfigTb4b4b4)Tb4b4b4.Te6edf3name Tb4b4b4}

Tb4b4b4}

Tff7b72fun Te6edf3ChannelSetTb4b4b4.Td2a8ffgetChannelTb4b4b4(Te6edf3indexTb4b4b4: Tffa657IntTb4b4b4)Tb4b4b4: Te6edf3Channel? Tff7b72= Tff7b72if Tb4b4b4(Te6edf3settingsTb4b4b4.Te6edf3size Tff7b72> Te6edf3indexTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3s Tff7b72= Te6edf3settingsTff7b72[Te6edf3indexTff7b72]

Te6edf3ChannelTb4b4b4(Te6edf3sTb4b4b4, Te6edf3lora_config Tff7b72?: Te6edf3LoRaConfigTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Tff7b72null

Tb4b4b4}

T8b949e/** Return the primary channel info */

Tff7b72val Te6edf3ChannelSetTb4b4b4.Te6edf3primaryChannelTb4b4b4: Te6edf3Channel?

Tff7b72getTb4b4b4(Tb4b4b4) Tff7b72= Te6edf3getChannelTb4b4b4(T79c0ff0Tb4b4b4)

Tff7b72fun Te6edf3ChannelSetTb4b4b4.Td2a8ffhasLoraConfigTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72= Te6edf3lora_config Tff7b72!Tff7b72= Tff7b72null

T8b949e/**

* Return a URL that represents the [ChannelSet]

*

* @param upperCasePrefix portions of the URL can be upper case to make for more efficient QR codes

*/

Tff7b72fun Te6edf3ChannelSetTb4b4b4.Td2a8ffgetChannelUrlTb4b4b4(Te6edf3upperCasePrefixTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72falseTb4b4b4, Te6edf3shouldAddTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72falseTb4b4b4)Tb4b4b4: Te6edf3CommonUri Tb4b4b4{

Tff7b72val Te6edf3channelBytes Tff7b72= Te6edf3ChannelSetTb4b4b4.Te6edf3ADAPTERTb4b4b4.Te6edf3encodeTb4b4b4(Tff7b72thisTb4b4b4)

Tff7b72val Te6edf3enc Tff7b72= Te6edf3channelBytesTb4b4b4.Te6edf3toByteStringTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3base64UrlTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff"Ta5d6ff=Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff"Tb4b4b4)

Tff7b72val Te6edf3p Tff7b72= Tff7b72if Tb4b4b4(Te6edf3upperCasePrefixTb4b4b4) Te6edf3CHANNEL_URL_PREFIXTb4b4b4.Te6edf3uppercaseTb4b4b4(Tb4b4b4) Tff7b72else Te6edf3CHANNEL_URL_PREFIX

Tff7b72val Te6edf3query Tff7b72= Tff7b72if Tb4b4b4(Te6edf3shouldAddTb4b4b4) Ta5d6ff"Ta5d6ff?add=trueTa5d6ff" Tff7b72else Ta5d6ff"Ta5d6ff"

Tff7b72return Te6edf3CommonUriTb4b4b4.Te6edf3parseTb4b4b4(Ta5d6ff"Tffd700$Te6edf3pTffd700$Te6edf3queryTa5d6ff#Tffd700$Te6edf3encTa5d6ff"Tb4b4b4)

Tb4b4b4}